##

Ergänzende Dokumentation zum

#

N.AES-Update

von Version 1.0.0 auf 1.1.0
18. Juli 1996
von
OverScan
Elbestr. 28-29
12045 Berlin
info@overscan.com, http://www.overscan.com

# Inhaltsverzeichnis

- 1 N.AES-Update von 1.0.0 auf 1.1.0
  - 1.1 Bezugsquellen
    - 1.1.1 OverScan-Mailbox
    - 1.1.2 OverScan WWW-Seiten
  - 1.2 Update-Installation
  - 1.3 Änderungen gegenüber Version 1.0.0
    - 1.3.1 N_AES.CNF: Neue Variable "export RSMASTER"
    - 1.3.2 N_AES.CNF: Neues Schlüsselwort "gemcon"
    - 1.3.3 N_AES.CNF: Neues Schlüsselwort "forward0"
    - 1.3.4 N_AES.CNF: Neues Schlüsselwort "numapps"
    - 1.3.5 Fehlerbereinigung: EGEM/Papyrus-Bug
    - 1.3.6 Fehlerbereinigung: N.Thing-Bug

# 1 N.AES-Update von 1.0.0 auf 1.1.0

Dieser Text ist Bestandteil des Updates der Multitasking-Software N.AES von Version 1.0.0 auf Version 1.1.0.

Die rechtlichen Bedingungen zu Kopie und Vertrieb von N.AES gelten unverändert (vgl. original-(N.AES-Anleitung).

## 1.1 Bezugsquellen

Neben dem direkten Bezug von Overscan (auf Diskette) ist dieses Update über die Overscan-Mailbox und die Overscan WWW-Seiten per DFÜ verfügbar. Es darf aber keinesfalls über andere Kanäle (Mailboxen, ftp-Server, WWW-Seiten o.ä.) verbreitet werden! Dies ist nicht als Schikane zu verstehen, sondern dient dazu, dem Anwender zu garantieren, über die genannten Quellen immer die aktuellste und unveränderte Original-Version zu erhalten.

### 1.1.1 OverScan-Mailbox

Die OverScan-Mailbox erreichen Sie unter der Rufnummer 030-624 95 14. Es handelt sich um eine "Maus-Mailbox".

- Zum Download des Updates melden Sie sich nach erfolgtem CONNECT als normaler Benutzer mit Ihrem Namen an.

- Wechseln Sie dann im Hauptmenü in den (P)rogrammteil.

- Wählen Sie den (G)ruppenprogrammteil "OverScan" aus.

- Holen Sie per (E)mpfangen die Datei `N_AES110.ZIP` auf Ihren Rechner.

### 1.1.2 OverScan WWW-Seiten

Im World Wide Web (WWW) des Internet finden Sie die OverScan-Seiten unter der Adresse http://www.overscan.com.

Das N.AES-Update ist unter http://www.overscan.com/overscan/n.aes verfügbar.

## 1.2 Update-Installation

Das Update wird als sogenannter "Patch" ausgeliefert. Die Patch-Dateien mit der Endung ".DFY" enthalten jeweils nur die Änderungen zwischen der Version 1.0.0 und 1.1.0 der betreffenden Dateien. Dadurch konnte das Update sehr klein gehalten werden.

Die Tabelle zeigt die mitgelieferten Dateien und ihren Zweck.

Dateiname | Zweck
NAES110.DFY | Patch-Datei für N_AES.SYS und N_AES030.SYS.
| Bitte in den N.AES-Ordner kopieren
| (meist C:\N_AES\).
NTHING.DFY | Patch-Datei für Thing.PRG
| Bitte in den N.Thing-Ordner kopieren
| (meist C:\THING\).
PATCHY.PRG | Das Patch-Programm
| Bitte jeweils einmal in den N.AES- und in den
| N.Thing-Ordner kopieren.
N_AES110.ASC | Dieser Text als ASCII-Dokument.
N_AES110.HYP | Dieser Text als ST-Guide-Dokument
| Bitte in den ST-Guide-Ordner kopieren
| (meist C:\HELP\).
N_AES110.HTM | Dieser Text als HTML-Dokument.
N_AES110.CNF | Eine beispielhafte Konfigurations-Datei für
| N.AES. Bitte in den N.AES-Ordner kopieren und
| nur dann in N_AES.CNF umbenennen, wenn Ihre
| N_AES.CNF-Datei seit der Erstinstallation
| nicht geändert wurde.

Im Update-Archiv bzw. auf der Update-Diskette sind die Dateien bereits in verschiedene Ordner verteilt, die der Standard-Installation von N.AES 1.0.0 entsprechen. Wenn Sie bei der Erstinstallation von N.AES also die Standard-Installation durch kopieren aller Dateien auf Ihr Boot-Laufwerk C: übernommen haben, so ist die Installation des Updates besonders einfach. Anwender, die eine abweichende Installation benutzen, müssen beim Lesen des folgenden Textes die Pfade entsprechend anpassen.

1. Kopieren Sie alle Dateien aus dem Update-Archiv bzw. von der Update-Diskette auf die Boot-Partition C: Ihrer Festplatte.

2. Stellen Sie sicher, daß nach diesem Kopiervorgang ca. 560 kByte freier Platz auf der Partition C: vorhanden ist (für Backups der alten Dateien).

3. Wechseln Sie in den Ordner `C:\N_AES` und ziehen Sie mit der Maus die Datei `NAES110.DFY` auf das Patch-Programm `PATCHY.TTP`.
   Dadurch werden die im gleichen Ordner vorhandenen Dateien N_AES.SYS und N_AES030.SYS von Version 1.0.0 in Version 1.1.0 geändert. Die alten Dateien werden im Unterordner `PATCHBAK` gesichert.

4. Falls Sie Ihre `N_AES.CNF`-Datei seit der Erstinstallation nicht geändert haben, löschen Sie diese und benennen Sie nun `N_AES110.CNF` in `N_AES.CNF` um.
   Andernfalls `N_AES.CNF` sollten Sie folgende Zeilen in der Datei hinzufügen:

   > `export RSMASTER=C:\N_AES\APPS\N_CHRES.PRG`
   > `gemcon=true`
   > `forward0=true`
   > `numapps=-1`

5. Wechseln Sie in den Ordner `C:\THING` und ziehen Sie mit der Maus die Datei `NTHING.DFY` auf das Patch-Programm `PATCHY.TTP`.
   Dadurch wird die im gleichen Ordner vorhandene Datei THING.APP fehlerbereinigt (die Versionsnummer bleibt gleich). Die alte Datei wird im Unterordner `PATCHBAK` gesichert.

6. Fertig. Starten Sie N.AES nun neu (Shutdown und Reset).

Sie sind jetzt im Besitz der Version 1.1.0 von N.AES. Nach erfolgreicher Installation und anschließendem Funktionstest durch neubooten können Sie wieder etwas Platz auf der Festplatte schaffen. Löschen Sie dazu folgende Dateien, die nun überflüssig geworden sind:

C:\N_AES\NAES110.DFY
C:\N_AES\PATCHY.TTP
C:\N_AES\PATCHBACK\N_AES.SYS
C:\N_AES\PATCHBACK\N_AES030.SYS

C:\THING\NTHING.DFY
C:\THING\PATCHY.TTP
C:\THING\PATCHBACK\THING.APP

Wir wünschen nun viel Spaß mit der neuen N.AES-Version. Die wesentlichen Unterschiede zur alten Version beschreibt der folgende Abschnitt.

An dieser Stelle möchten wir noch Christian Wempe und Holger Weets herzlich für Das Programmpaket "DIFFY2" danken, mit dessen Hilfe die Patch-Dateien (*.DFY) erzeugt wurden. Auch das Patch-Programm `PATCHY.TTP`, das Bestandteil dieses Updates ist, stammt aus der Feder der genannten Autoren.

## 1.3 Änderungen gegenüber Version 1.0.0

Dieser Abschnitt beschreibt die Änderungen zwischen N.AES-Version 1.0.0 und der aktuellen Version 1.1.0 in ungeordneter Reihenfolge.

### 1.3.1 N_AES.CNF: Neue Variable "export RSMASTER"

In der Datei N_AES.CNF (meist im Ordner C:\N_AES) kann eine neue Environment-Variable für den sogenannten Auflösungswechsel-Master gesetzt werden. Beispiel:

> `export RSMASTER=C:\N_AES\APPS\N_CHRES.PRG`

Ähnlich dem (!stglink ["Shutdown-Master" (vgl. N.AES-Anleitung)] [n_aes.hyp/Shutdown]) ist es damit möglich, per Tastatur einen Auflösungswechsel durch die Tastenkombination

> `[Control]`-`[Alternate]`-`[R]`

zu initieren. Das Ergebnis ist das gleiche, als würde N.ChRes direkt gestartet.

Fehlt RSMASTER im Environment, so funktioniert `[Control]`-`[Alternate]`-`[R]` nicht und der Menüeintrag System/Auflösungswechsel im Minimal-Desktop N.Desk bleibt inaktiv.

### 1.3.2 N_AES.CNF: Neues Schlüsselwort "gemcon"

Bestimmte ältere Programme (z.B. OMICRON-BASIC) empfangen unter N.AES u.U. keine Tastatureingaben. Dies liegt daran, daß diese Programme sich auf unterster Ebene in BIOS-Vektoren hängen und dort Ihre Tastatureingaben erwarten. Dieses Verhalten ist unter Multitasking-Systemen wie N.AES illegal!

Da leider nicht mehr damit zu rechnen ist, daß solche fehlerhaften Programme in Zukunft bereinigt werden, steht N.AES als sogenannter "Workaround" das Schlüsselwort "gemcon" zur Verfügung.

Sollten Sie mit dem o.g. Problem fehlender Tastatureingaben zu kämpfen haben (und nur dann), nehmen Sie bitte die Zeile

> `gemcon=false`

in die Datei N_AES.CNF mit auf.

Dadurch wird die N.AES-interne Verarbeitung der Tastatureingaben so geändert, daß die Probleme nicht mehr auftauchen.

Ausdrücklich sei aber nochmals darauf hingewiesen, daß gemcon=false eine Notlösung darstellt, die dem Multitasking-Konzept von N.AES widerspricht. Sie sollten möglichst bald Ersatz für Ihre fehlerhaften Anwendungen suchen, damit mit `gemcon=true` (default) wieder das "bessere" Verfahren für Tastatureingaben benutzt werden kann.

### 1.3.3 N_AES.CNF: Neues Schlüsselwort "forward0"

Wenige Anwendungen gehen fälschlicherweise davon aus, daß der Desktop die Applikations-ID "0" hat. Ähnliche Irrtümer können auftreten, wenn ein Programm eine AES-Nachricht an ein anderes Programm schickt und dabei als Absender-ID "0" einträgt. Die Anwendung, die auf diese Nachricht reagiert, sendet dann wieder an die falsche ID. Dadurch kommt es schlimmstensfalls zu einem "System-Hänger", da die Anwendungen ewig auf eine Antwort warten.

Um dies zu umgehen, wurde das neue Schlüsselwort "forward0" eingeführt. Bei

> `forward0=true`

(ist auch Default) werden Nachrichten an die Anwendung mit der ID "0" an den Desktop weitergeleitet.

Durch diesen Workaround wird ein Fehler in Thing bzw. N.Thing behoben, der bis Version 1.01 existiert. Dadurch funktioniert z.B. auch KOBOLD3.ACC problemlos mit N.Thing unter N.AES.

### 1.3.4 N_AES.CNF: Neues Schlüsselwort "numapps"

N.AES meldet - wie schon MultiTOS - den Anwendungen auf Nachfrage, daß beliebig viele Programme gleichzeitig gestartet werden können. Dazu erhält eine bestimmte Systemvariable per Definition den Wert "-1". Leider gibt es auch hier Anwendungen, die diesen Wert nicht verstehen (z.B. ältere Versionen von ProgList und PacShell).

Als weiteren Workaround bietet N.AES 1.1.0 das neue Schlüsselwort "numapps", mit dem der Default-Wert "-1" beliebig neu gesetzt werden kann. Fügen Sie dazu z.B. die Zeile

> `numapps=4711`

in Ihre N_AES.CNF ein. Wichtig ist nur, daß die Zahl ausreichend groß (max. Anzahl der gleichzeitig möglichen Anwendungen) und gleichzeitig kleiner als 32.767 ist.

Nachteil: Mindestens eine Anwendung ist bekannt, die nur "-1" als Wert aktzeptiert (und damit MultiTOS bzw. N.AES erkennt): MINIWIN.APP aus dem MultiTOS-Paket von ATARI.
Abhilfe: TOSWIN.APP oder TW100.APP anstelle von MINIWIN.APP benutzen.

### 1.3.5 Fehlerbereinigung: EGEM/Papyrus-Bug

Durch Nutzung einer undokumentierten AES-Funktion funktionierten Programme, die mit der sogenannten "EGEM-Bibliothek" arbeiten, nicht korrekt mit der N.AES-Version 1.0.0. Davon war z.B. das Textverarbeitungsprogramm "Papyrus" ab Version 4 betroffen.

Dieser Fehler tritt in der N.AES-Version 1.1.0 nun nicht mehr auf. Allen Benutzern von EGEM-Programmen wird daher dringend das N.AES-Update empfohlen, da es sonst zu unkontrollierten Fehler beim Betrieb von N.AES kommen kann.

### 1.3.6 Fehlerbereinigung: N.Thing-Bug

Durch den Patch NTHING.DFY wird ein Fehler des Desktops N.Thing 1.01, der mit N.AES mitgeliefert wird, in Zusammenhang mit dem AVSERVER behoben (AV_STARTPROG ohne Parameter war nicht möglich).

Dadurch funktionierem nun auch Programme wie "Start Me Up" wieder problemlos mit N.AES.